Skip to content

feat(skills): add review-changes orchestrator + universal reviewer template#13

Merged
breadoncee merged 3 commits into
mainfrom
feat/universal-reviewer-template
Mar 10, 2026
Merged

feat(skills): add review-changes orchestrator + universal reviewer template#13
breadoncee merged 3 commits into
mainfrom
feat/universal-reviewer-template

Conversation

@breadoncee

Copy link
Copy Markdown
Collaborator

Summary

  • Adds review-changes skill: an end-to-end orchestrator that chains the full review pipeline with user checkpoints between each phase:
    1. Phase 1 — Handoff: auto-generates structured handoff doc (auto-detects build system)
    2. Phase 2 — Review: asks user to self-review (Claude reviews inline) or copy a paste-ready prompt for any external AI provider
    3. Phase 3 — Fix: asks user if they want to fix findings, then applies them with confirmation
  • Replaces provider-specific templates (codex, gemini, generic) in create-review with one universal reviewer.template.md that works with any AI model
  • Bumps create-review to v1.1.0

Test plan

  • Run scripts/validate-skills.sh — all 12 skills pass
  • Test /review-changes self-review path on a branch with changes
  • Test /review-changes external review path (generates prompt, waits for user)
  • Test that Phase 3 fix flow correctly loads findings and applies with confirmation
  • Verify universal template output format is parseable by fix-findings skill

…al reviewer template

- Remove separate codex/gemini/generic templates in favor of one
  universal reviewer.template.md that works with any AI model
- Template includes structured output format (verdict, findings table,
  testing gaps, open questions) usable by any reviewer agent
- Reviewer argument is now just a label for the output filename
- Bump create-review to v1.1.0
…template

- Add review-changes: end-to-end skill that chains handoff → review → fix
  with user checkpoints between each phase. Supports self-review (Claude
  reviews inline) or external review (paste-ready prompt for any provider)
- Replace provider-specific templates in create-review with one universal
  reviewer.template.md that works with any AI model
- Bump create-review to v1.1.0
@gemini-code-assist

Copy link
Copy Markdown

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the code review workflow by introducing an orchestrated skill that streamlines the entire process from initial handoff generation to applying suggested fixes. It also standardizes the AI review prompt format, making the system more flexible and easier to use with various AI models. These changes aim to provide a more comprehensive and user-friendly experience for conducting and acting upon AI-assisted code reviews.

Highlights

  • New review-changes Orchestrator Skill: Introduced an end-to-end review pipeline skill that guides users through three phases: Handoff (auto-generates a structured document), Review (offers self-review or external AI prompt generation), and Fix (applies findings with user confirmation).
  • Universal Reviewer Template: Replaced multiple provider-specific review templates (e.g., Codex, Gemini, generic) with a single, universal reviewer.template.md. This template provides a standardized output format for AI models, improving consistency and simplifying integration.
  • create-review Skill Update: The create-review skill was updated to leverage the new universal reviewer template and its version was bumped to v1.1.0.
Changelog
  • skills/create-review/SKILL.md
    • Updated the skill's description to reflect its broader applicability to 'any reviewer agent'.
    • Bumped the skill version from 1.0.0 to 1.1.0.
    • Modified the argument hint to clarify that the reviewer name is optional and used for labeling.
    • Refactored the template selection logic to exclusively use the new universal reviewer.template.md instead of provider-specific or generic templates.
    • Replaced the content for multiple provider-specific templates with a single, detailed reviewer.template.md that defines a standardized output format for AI reviews.
    • Updated the skill's usage instructions to reflect the adoption of the universal template and how to interact with various AI models.
  • skills/review-changes/SKILL.md
    • Added a new skill definition for review-changes, an end-to-end orchestrator for the review pipeline.
    • Detailed the three phases of the review-changes skill: Handoff, Review, and Fix Findings, including sub-steps for each.
    • Specified how the skill determines session names, creates session directories, detects base branches, gathers context, and runs project checks.
    • Outlined the structure for writing the handoff document.
    • Described options for the Review phase, including self-review (Claude) and external review (generating a paste-ready prompt).
    • Defined the process for the Fix Findings phase, covering loading, parsing, prioritizing, presenting, and applying fixes with user confirmation.
    • Included rules for the skill's operation, emphasizing user confirmation, honesty about failures, and validation of file paths.
  • skills/skills-index.yaml
    • Updated the version of the create-review skill from 1.0.0 to 1.1.0.
    • Added a new entry for the review-changes skill with version 1.0.0.
Activity
  • The pull request was created by breadoncee to introduce a new review-changes orchestrator skill and a universal reviewer template, alongside updating the create-review skill.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces the review-changes orchestrator skill, automating the review pipeline, and refactors the create-review skill for standardization. However, significant security concerns exist due to the handling of untrusted user input and dynamic shell script generation, posing risks of Command Injection and Remote Code Execution (RCE) via prompt injection. Additionally, there are inconsistencies in the session directory path affecting interoperability with skills like fix-findings, internal variable naming inconsistencies ({session} vs. {session_name}), and vague shell command examples that need addressing for robustness.

Comment thread skills/review-changes/SKILL.md Outdated
Comment thread skills/review-changes/SKILL.md Outdated
Comment thread skills/review-changes/SKILL.md Outdated
Comment thread skills/review-changes/SKILL.md Outdated
Comment thread skills/review-changes/SKILL.md Outdated
Comment thread skills/review-changes/SKILL.md Outdated
- Use shell command for argument sanitization instead of LLM interpretation (security)
- Fix session path: .chalk/reviews/sessions/ for consistency with other skills
- Delegate script bootstrapping to /create-review instead of inline generation (security)
- Use explicit positional args for render-prompt.sh instead of vague ellipsis
- Normalize variable name to {session_name} throughout skill
@breadoncee
breadoncee merged commit 1b65598 into main Mar 10, 2026
1 check passed
@breadoncee
breadoncee deleted the feat/universal-reviewer-template branch March 10, 2026 06:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant